home *** CD-ROM | disk | FTP | other *** search
/ Revolution - Das Atari CD Magazin 1997 / Revolution - Das Atari CD Magazin 1.iso / software / dtp / calamodu / bombadil / liesmich.txt < prev   
Text File  |  1996-07-01  |  18KB  |  432 lines
  1.  
  2.    BOMBADIL - Modul zur Behebung einiger Calamus-Fehler
  3.    -----------------------------------------------------------------------------
  4.    Entwickelt von Harald Siegmund @ KL (Mausnet)
  5.  
  6.    (bitte lesen Sie auch die Datei BOMBADIL.TXT!)
  7.  
  8.  
  9.    Wozu?
  10.    -----
  11.    In allen bekannten Versionen von Calamus S und SL steckt ein Fehler, der
  12.    beim Transport von Objekten über das Clipboard die Datenstrukturen
  13.    derselben beschädigen kann. Da erst eine ganze Reihe vom Umständen
  14.    zusammenkommen muß, damit dieser "Bug" zuschlägt, tritt er ziemlich
  15.    selten auf, was ihn recht heimtückisch macht: scheinbar ohne Zusammenhang
  16.    lassen sich plötzlich Objekte nicht mehr ins Dokument übertragen.
  17.    Aufgrund dieses nicht reproduzierbaren Verhaltens dauerte es nach der
  18.    Veröffentlichung von Calamus S/SL mehrere Jahre, bis dieser Fehler
  19.    aufgedeckt und lokalisiert werden konnte.
  20.  
  21.    Schuld an diesem Fehlverhalten ist übrigens nicht das Clipboard, sondern
  22.    ein Teil der allgemeinen Dokumentstruktur-Verwaltung. Die zum Auslösen
  23.    des Fehlers notwendigen Voraussetzungen konnten lange Zeit nur vom Clipboard
  24.    eingebracht werden. Unerklärliche Effekte bei der Entwicklung des
  25.    Texteditors "Eddie" brachten dann die Hintergründe dieses Fehlers ans
  26.    Licht. Es ist durchaus möglich, daß noch andere Funktionen des Calamus-
  27.    Systems davon betroffen sind.
  28.  
  29.    Der Fehler ist konzeptioneller Natur und leider nicht durch einen einfachen
  30.    Patch zu beseitigen. Die Auswirkungen sind sehr komplex und ohne
  31.    Erläuterungen der technischen Zusammenhänge fast unmöglich zu beschreiben.
  32.    Nur soviel: Es gehen bestimmte Referenzen von Objekten in ihr Ursprungs-
  33.    dokument verloren. Werden Änderungen an Farb- oder Stilliste im Dokument
  34.    vorgenommen, so erfolgt keine Aktualisierung der geclippten Objekte mehr.
  35.  
  36.    BOMBADIL ist jedenfalls als eine Art "Wächter" konzipiert: Das Modul
  37.    "beobachtet" die Dokumentenstruktur und greift bei Fehlern ein, um diese
  38.    zu korrigieren.
  39.  
  40.  
  41.  
  42.    Wozu noch?
  43.    ----------
  44.    Im Laufe der Zeit hat sich BOMBADIL regelrecht zu einer Sammlung von
  45.    Bugfixes gemausert. Mittlerweile können neun bekannte Fehler von
  46.    Calamus und seinen Modulen umgangen bzw. deren Symptome beseitigt
  47.    werden:
  48.  
  49.    ∙ Der Strukturfehler, der u.a. bei Clipboard-Operationen auftreten kann
  50.      (Beschreibung siehe oben).
  51.  
  52.    ∙ Alle Versionen ab 1994 des Calamus Dokumentkonverters haben Probleme
  53.      beim Laden mancher alter Dokumente, die mit Calamus 1.09 erzeugt
  54.      wurden. Normalerweise wird für diese Dokumente beim Laden eine Farb-
  55.      sowie Farbebenenliste (für die Schmuckfarben) erzeugt. Aus irgendeinem
  56.      Grund läßt der Konverter in einigen Fällen die Farbebenenliste weg.
  57.      Ab Version 5 ist BOMBADIL in der Lage, diesen Zustand zu erkennen und
  58.      zu beheben. Die Funktionalität steckt im Clipboard-Bugfix und kann mit
  59.      diesem zusammen ein- und ausgeschaltet werden.
  60.  
  61.    ∙ Mit Betriebssystemerweiterungen wie z.B. WinCom ist es möglich, Fenster
  62.      auch über den linken Bildschirmrand hinaus zu schieben. Leider reagiert
  63.      Calamus auf solche Aktionen mit sprachloser Systemverwirrung: das
  64.      Fenster wird auf volle Größe aufgebläht und springt über den Bildschirm.
  65.  
  66.      Dieser Bugfix sorgt dafür, daß Fenster korrekt über den linken Bildschirm-
  67.      rand geschoben werden können.
  68.  
  69.    ∙ Manchmal gerät die Stilliste eines Dokuments etwas durcheinander.
  70.      Textrahmen lassen sich nicht mehr formatieren oder Änderungen an Stilen
  71.      haben keinerlei Auswirkungen mehr auf das Dokument. In solchen Fällen
  72.      sollte die in BOMBADIL eingebaute Prüffunktion auf den Text angewendet
  73.      werden, die "verlorengegangene" Stile wieder richtig in die Stilliste
  74.      einsortieren kann.
  75.  
  76.    ∙ Die vom Rastergenerator erzeugten Caches werden an das jeweilige
  77.      Dokument gehängt und auch mit diesem abgespeichert. Unglücklicherweise
  78.      enthält der in der 1993er Calamus-Version eingebaute Mechanismus zum
  79.      Löschen von Caches einen Fehler: Rastercaches werden NIE gelöscht.
  80.      Dadurch wächst ein Dokument im Laufe der Zeit durch immer mehr Raster-
  81.      caches zu ungeahnten Größen an. Mit Hilfe von BOMBADIL kann man diese
  82.      Caches wieder loswerden.
  83.  
  84.    ∙ Durch bestimmte Aktionen können im Dokument Farben mit einem ungültigen
  85.      Format entstehen. Als Folge hiervon ist zum Beispiel der Zugang zum
  86.      Farbformular nicht mehr möglich. Eine bekannte Ursache dieses Problems
  87.      ist das Bridge-Modul: beim Konvertieren von Textrahmen mit unter-
  88.      strichenem Text in Vektorrahmen entstehen regelmäßig defekte Objekt-
  89.      farben. Dieser Bugfix ist in der Lage, solche Farben zu finden und zu
  90.      reparieren.
  91.  
  92.    ∙ Unter MagiC bzw. MagiCMac kann es zum Absturz oder Systemhänger kommen,
  93.      wenn das Task-Popup (das man beim Klick in die Menüleiste erhält)
  94.      geöffnet wird. Schuld daran ist die Tastencodeanzeige in der Kopfzeile
  95.      von Calamus. Der Fehler läßt sich auf folgende Art und Weise
  96.      reproduzieren:
  97.  
  98.      - Klick in die Menüleiste um das Popup zu öffnen
  99.      - Mit der Maus in der Kopfzeile hin- und herfahren
  100.      - Die Maus zurück in das Popup bewegen -> das System hängt sich auf
  101.        oder stürzt ab
  102.  
  103.      Mit dem entsprechenden Bugfix läßt sich die Tastencodeanzeige abschalten,
  104.      damit es nicht mehr zu diesem Effekt kommen kann.
  105.  
  106.    ∙ Wenn eine Reihe von Bedingungen erfüllt ist, stürzt Calamus bei der
  107.      Ausgabe von Maskengruppen ab. Der Fehler tritt auf, wenn
  108.  
  109.      - es sich um invertierte Masken handelt
  110.      - die Ausgabe gedreht erfolgt
  111.      - in einer relativ hohen Auflösung ausgegeben wird
  112.  
  113.      Schließlich kommt noch ein weitgehend unberechenbares Zufallselement
  114.      hinzu, da dieser Bug mit einer nicht initialisierten Programmvariable
  115.      zusammenhängt. Je nachdem, was gerade an der entsprechenden Speicherstelle
  116.      steht, kommt es zu einem Absturz (2 Bomben) oder nicht.
  117.  
  118.    ∙ Sehr sporadisch kommt es beim Belichten von Seiten mit großen RGB-
  119.      oder CYMK-Bildern zu einem Absturz mit zwei Bomben und dem Zusatzcode
  120.      "PICt, PICt, PICs, MOD SCOS". Je größer der vorhandene Arbeitsspeicher,
  121.      die Bilddaten und die Ausgabeauflösung, desto wahrscheinlicher wird
  122.      dieser Fehler. Bombadil ist in der Lage, den Defekt in der Bildausgabe
  123.      zu finden und zu beheben.
  124.      Dieser Bugfix arbeitet nur auf Calamus-Versionen ab 1994.
  125.  
  126.  
  127.  
  128.    Installation
  129.    ------------
  130.    Installiert wird BOMBADIL wie jedes andere Modul auch:
  131.  
  132.    ∙ Kopieren Sie bitte eine der beiden BOMBADIL-Versionen (BOMBADIL.CXM)
  133.      in den Modul-Ordner Ihres Calamus (entweder aus CAL93\ oder CAL94\ -
  134.      abhängig davon, mit welcher Calamus-Version Sie arbeiten).
  135.  
  136.    ∙ Starten Sie Calamus und laden Sie BOMBADIL.CXM im Formular
  137.      "Externe Module".
  138.  
  139.    ∙ Wenn BOMBADIL beim Starten von Calamus automatisch geladen werden soll,
  140.      dann wählen Sie bitte in der Menüleiste unter "SONSTIGES" den Punkt
  141.      "Einstellungen sichern..." an. Speichern Sie die Einstellungen der
  142.      Gruppe "Module" wie gewohnt.
  143.  
  144.  
  145.  
  146.    Bedienung
  147.    ---------
  148.    BOMBADIL wird durch Anwählen des Moduls und Klick auf "AUSFÜHREN" im
  149.    Formular "Externe Module" aufgerufen. Es erscheint eine Übersicht aller
  150.    eingebauten Funktionen. Klicken Sie auf das jeweilige Icon, um die
  151.    Funktionen zu konfigurieren bzw. aufzurufen.
  152.  
  153.  
  154.    Formular "Stile und Farben von über das Clipboard kopierten Objekten"
  155.  
  156.       Bugfix ist aktiv
  157.          Wenn angewählt, so ist die Strukturüberprüfung eingeschaltet.
  158.  
  159.       Protollfenster
  160.          Im Protokollfenster werden Informationen über notwendige Korrekturen
  161.          der Dokumentstruktur angezeigt.
  162.  
  163.          geschlossen
  164.             Das Fenster bleibt geschlossen.
  165.  
  166.          im Korrekturfall öffnen
  167.             Sobald BOMBADIL eine Reparaturarbeit erledigt, wird das Fenster
  168.             geöffnet und bleibt danach auch offen.
  169.  
  170.          offen
  171.             Das Fenster wird geöffnet.
  172.  
  173.       Maximal ___ Zeilen
  174.          Hiermit wird festgelegt, wieviel Protokollzeilen sich BOMBADIL im
  175.          Fenster "merken" soll.
  176.  
  177.       akustisches Signal im Korrekturfall
  178.          Unabhängig vom Protollfenster kann eingestellt werden, ob während
  179.          der Reparaturarbeiten ein Klingelton ausgegeben werden soll.
  180.  
  181.       Alle Einstellungen lassen sich in einer Setup-Datei ablegen (Funktion
  182.       "SPEICHERN"). Dort wird auch die aktuelle Position und Größe des
  183.       Protokollfensters abgelegt.
  184.  
  185.  
  186.    Formular "Falsche Stil-Referenzen in Textrahmen"
  187.  
  188.       Hier können Sie zwei Funktionen ausführen lassen:
  189.  
  190.       PRÜFEN
  191.          Sämtliche Textstrukturen im aktuellen Dokument werden überprüft.
  192.  
  193.       REPARIEREN
  194.          Zusätzlich zur Überprüfung versucht BOMBADIL, gefundene Defekte
  195.          zu reparieren.
  196.  
  197.       In beiden Fällen wird nach der Aktion eine Fehler-Statistik angezeigt.
  198.  
  199.  
  200.    Formular "Rastercaches können nicht gelöscht werden (93er Version)"
  201.  
  202.       Diese Funktion wird normalerweise nur in einem 1993er Calamus
  203.       benötigt. Hier können Sie durch Anwählen von "LÖSCHEN" sämtliche
  204.       Rastercaches wegwerfen lassen.
  205.  
  206.  
  207.    Formular "Objektfarben mit ungültigem Format"
  208.  
  209.       Dieses Formular ist analog zu dem der Text-Prüffunktion aufgebaut.
  210.       Es gibt wiederum einen PRÜFEN und einen REPARIEREN-Knopf, mit denen
  211.       sämtliche Farben im aktuellen Dokument kontrolliert werden können.
  212.       Zur Reparatur einiger defekter Farben muß BOMBADIL eine Ersatzfarbe
  213.       anlegen, die hinten an die Farbliste angehängt wird. Im Fehler-
  214.       statistik-Formular wird darüber Auskunft gegeben.
  215.  
  216.  
  217.    Formular "Bewegen von Fenstern über den linken Bildschirmrand hinaus"
  218.    Formular "Öffnen des MagiC Task-Popups kann zum Absturz führen"
  219.    Formular "Invertierte Masken können bei gedrehter Ausgabe abstürzen"
  220.  
  221.       Alle diese Formulare sind gleich aufgebaut. Sie enthalten einen
  222.       Schalter zum Aktivieren des Bugfixes sowie einen Knopf zum Speichern
  223.       der Einstellungen.
  224.  
  225.  
  226.    Registrierungsformular
  227.  
  228.       BOMBADIL liegt in einer unregistrierten Version vor, die ab und zu
  229.       mit einer Hinweismeldung an diesen Zustand erinnert. Bei Zahlung
  230.       des Shareware-Beitrags erhalten Sie einen Registrierungsschlüssel,
  231.       den Sie zusammen mit Ihrem Namen in diesem Formular eingeben.
  232.       Die Registrierungsdaten werden daraufhin automatisch in BOMBADILs
  233.       Setup-Datei abgelegt und beim nächsten mal von dort eingelesen.
  234.  
  235.       Ist BOMBADIL bereits erfolgreich registriert worden, können Name
  236.       und Schlüssel in diesem Formular nicht editiert werden. Außerdem
  237.       ist der ABBRUCH-Knopf dann ausgeblendet.
  238.  
  239.       Nähere Informationen zum Programmstatus sowie zur Registrierung finden
  240.       Sie weiter unten im Text.
  241.  
  242.  
  243.  
  244.    Meldungen
  245.    ---------
  246.    Hier die wichtigsten Meldungen, die BOMBADIL im Protokollfenster
  247.    anzeigen kann:
  248.  
  249.    "Fehler in Stillisten-Referenzen erkannt und repariert"
  250.     oder
  251.    "Fehler in Farblisten-Referenzen erkannt und repariert"
  252.     oder
  253.    "Fehler in Farbebenenlisten-Referenzen erkannt und repariert"
  254.  
  255.     In der jeweiligen Struktur wurde ein Fehler entdeckt und beseitigt.
  256.     Diese Meldung ist lediglich als Hinweis zu verstehen. Zusätzlich werden
  257.     noch einige weitere Informationen angezeigt:
  258.  
  259.     "Dokument: <x>"
  260.     "Objekt-ID (alt): <x>"    <- Diese Angaben sind lediglich zu Debugging-
  261.     "Objekt-ID (neu): <x>"    <- Zwecken nützlich und können getrost ignoriert
  262.     "Netz-Koeffizient: <x>"   <- werden.
  263.  
  264.  
  265.    "Fehlende Farbebenenliste erkannt und durch neue ersetzt"
  266.  
  267.     Der Dokumentkonverter hat "vergessen", an ein eben geladenes 1.09N-
  268.     Dokument eine Farbebenenliste zu hängen. Bombadil hat das stattdessen
  269.     erledigt.
  270.  
  271.  
  272.    "!! Unerwarteter Fehler <x> in Funktion <y> !!"
  273.  
  274.     BOMBADIL hat von Calamus Informationen über das Dokument angefordert und
  275.     dabei eine Fehlermeldung erhalten. Das Dokument hat einen Schaden, den
  276.     BOMBADIL nicht beheben kann.
  277.  
  278.  
  279.    "!! Unerwarteter Fehler <x> bei der Reparatur !!"
  280.  
  281.     Beim Neuverknüpfen der Dokumentobjekte wurde von Calamus ein Fehler
  282.     gemeldet. Achtung: Das Dokument ist schwer beschädigt und sollte zur
  283.     Sicherheit unter einem NEUEN Namen abgespeichert werden (die alte
  284.     Version auf der Festplatte kann durchaus noch intakt sein).
  285.  
  286.    Beim Auftreten unerwarteter Fehler stellt BOMBADIL die Überwachung des
  287.    betroffenen Dokuments ein.
  288.  
  289.  
  290.  
  291.    Versionen
  292.    ---------
  293.    Version 1   17.02.95
  294.       Erste veröffentlichte Version
  295.  
  296.    Version 2   02.06.95
  297.       Im Korrekturfall schickt BOMBADIL nun ein Update-Ereignis an alle
  298.       betroffenen Module
  299.  
  300.       BOMBADIL behebt nun einen weiteren Calamus-Bug: Beim Einsatz von
  301.       Betriebssystemerweiterungen wie z.B. WinCom lassen sich nun die
  302.       Calamus-Fenster links aus dem Bildschirm herausschieben,
  303.       ohne daß Calamus dabei ausflippt.
  304.  
  305.    Version 3   16.08.95
  306.       Die Funktionen zur Textstruktur-Überprüfung und zum Löschen von
  307.       Rastercaches wurden eingebaut. Die Bedienoberfläche wurde
  308.       geändert.
  309.  
  310.    Version 4   28.11.95
  311.       Die Texte einiger Fehlermeldungen wurden geändert.
  312.  
  313.    Version 4A  14.02.96
  314.       Sonderversion, die dem Texteditor EDDIE (ab Version 2) beiliegt.
  315.       Entspricht Version 4 mit der in Version 9 vorgenommenen Erweiterung
  316.       des Fenster-Bugfixes.
  317.  
  318.    Version 5   16.01.96
  319.       Wenn die Farbebenenliste eines Dokuments fehlt, kann BOMBADIL diese
  320.       nun reproduzieren und in das Dokument einhängen. Dieses Problem tritt
  321.       manchmal beim Laden alter 1.09 Dokumente auf.
  322.  
  323.       Tritt ein unerwarteter Fehler auf, beendet BOMBADIL die Überwachung
  324.       des betroffenen Dokuments. Die nervtötenden Endlosmeldungen sollten
  325.       damit der Vergangenheit angehören.
  326.  
  327.    Version 6   18.01.96
  328.       Der Mechanismus zum Reparieren von Objektfarben wurde hinzugefügt.
  329.  
  330.       BOMBADIL muß nun registriert werden, sonst nervt er ab und zu mit
  331.       einer entsprechenden Hinweismeldung. Ansonsten ist die Funktionalität
  332.       jedoch nicht eingeschränkt.
  333.  
  334.    Version 7   19.01.96
  335.       Der Bugfix für Task-Popup/Tastencodeanzeige wurde hinzugefügt.
  336.  
  337.    Version 8   05.02.96
  338.       Beim Öffnen des Protokollfensters stürzte Bombadil ab, wenn zuerst
  339.       ein defektes Dokument und danach erst Bombadil geladen wurde.
  340.  
  341.       Die CYMK-Werte der von Bombadil erzeugten Ersatzfarbe werden nun
  342.       richtig gesetzt (C, Y und M auf 0, K aber auf 255).
  343.  
  344.       Die Bedienung der Prüfformulare wurde noch ein wenig effizienter
  345.       gestaltet.
  346.  
  347.    Version 9   03.06.96
  348.       Der Fenster-Bugfix wurde noch etwas verbessert (ändern der Größe
  349.       eines links aus dem Bildschirm hinausgeschobenen Fensters mißachtete
  350.       ein eventuell eingestelltes Snap-Raster).
  351.  
  352.       Der Maskengruppen-Bugfix wurde hinzugefügt.
  353.  
  354.    Version 10  14.06.96
  355.       Neuer Bugfix, der den Absturzfehler beim Belichten großer Bilder behebt.
  356.  
  357.    Version 11  01.07.96
  358.       Der in BOMBADIL 10 eingebaute Bugfix hatte einen Fehler!! Bei der Ausgabe
  359.       von Duochrom-Bildern oder separiertem Drucken von monochromen Bildern
  360.       stürzte Calamus immer ab.
  361.  
  362.  
  363.  
  364.    Support
  365.    -------
  366.    Die aktuelle Version von BOMBADIL liegt im öffentlichen Programmteil der
  367.    Maus-Mailbox Kaiserslautern (Maus KL).
  368.  
  369.    Tel.   : +49-631-17901
  370.    Archiv : BOMBADIL.LZH
  371.    Hinweis: Download für Nicht-Zahler gesperrt von 7-9 und 17-19 Uhr
  372.  
  373.    Fragen zu BOMBADIL können in der Maus-Gruppe ATARI.DTP gestellt oder direkt
  374.    an den Autor (Harald Siegmund @ KL) gerichtet werden. Veröffentlichungen
  375.    von neuen Versionen werden in ATARI.NEWS dokumentiert.
  376.  
  377.  
  378.  
  379.    Nutzungs- und Verbreitungshinweise
  380.    ----------------------------------
  381.    BOMBADIL ist Shareware. Das Modul darf kopiert und an andere weiter-
  382.    gegeben werden, allerdings ausschließlich in der Originalzusammenstellung
  383.    mit allen Dateien. Wenn BOMBADIL Ihnen bei der Arbeit mit Calamus hilft,
  384.    dann bitte ich Sie, den Shareware-Beitrag von DM 20,- auf folgendes Konto
  385.    zu überweisen:
  386.  
  387.       Sparda Bank Mainz eG
  388.       BLZ 550 905 00
  389.       Konto 300 405
  390.  
  391.    Bitte geben Sie auch Ihren Namen bei der Überweisung mit an! Den
  392.    Registrierungsschlüssel können Sie sich per PM anfordern bei:
  393.    Harald Siegmund @ KL (im Mausnetz). Sollten Sie keinen Zugang zum
  394.    Mausnetz haben, so tragen Sie bitte auch Ihre vollständige(!) Anschrift
  395.    in die Betreffzeilen der Überweisung ein, damit ich Ihnen den Schlüssel
  396.    zukommen lassen kann.
  397.  
  398.    Solange BOMBADIL nicht registriert ist, erscheint nach dem Verlassen
  399.    des Hauptformulars sowie nach einer bestimmten Anzahl von ausgegebenen
  400.    Zeilen im Protokollfenster eine Hinweismeldung. Ansonsten liegen keine
  401.    Einschränkungen vor.
  402.  
  403.    Der Sharewarebeitrag versteht sich ausschließlich als Spende sowie
  404.    Motivation für den Autor, BOMBADIL und andere Zusatzprogramme rund
  405.    um Calamus zu entwickeln und zu pflegen. Durch die Zahlung des
  406.    Beitrags können keine besonderen Ansprüche auf Support geltend
  407.    gemacht werden. Es kann auch nicht garantiert werden, daß durch
  408.    den Einsatz von BOMBADIL bestimmte Probleme mit Calamus gelöst
  409.    werden können.
  410.  
  411.    Die Benutzung von BOMBADIL erfolgt auf eigene Gefahr. Die Software
  412.    wurde vor Freigabe jedoch nach bestem Wissen und Gewissen getestet
  413.    und befindet sich auf meinem Rechner täglich im Einsatz.
  414.  
  415.  
  416.    Viel Erfolg mit BOMBADIL wünschen
  417.  
  418.       Harald Siegmund (Programmautor)
  419.       Raimund Thiel (Textidee)
  420.  
  421.    -----------------------------------------------------------------------------
  422.  
  423.    Ein letztes Wort:
  424.  
  425.       "We apologise for the inconvenience"
  426.  
  427.    (Douglas Noel Adams)
  428.  
  429.  
  430.  
  431.    Calamus® ist ein eingetragenes Warenzeichen der Firma MGI.
  432.